home *** CD-ROM | disk | FTP | other *** search
/ Nothing but Tetris / Nothing but Tetris.iso / tools / amiga / flick.doc < prev    next >
Encoding:
Text File  |  1994-08-08  |  4.3 KB  |  153 lines
  1.  
  2.         Flick FLI-format Animation Viewer v1.0          19 Dec 1993
  3.         --------------------------------------
  4.  
  5.  
  6. This program plays 320x200x8 FLI-format bitmapped animation files on
  7. any ECS or AGA Amiga running OS2.04 or higher.  FLI-format files are
  8. produced by Autodesk Animator and Autodesk 3D Studio on a PC, as well
  9. as by other programs.
  10.  
  11. The files in this archive may be distributed anywhere provided they are
  12. unmodified and are not sold for profit.
  13.  
  14. Ownership and copyright of all files remains with the author:
  15.  
  16.     Peter McGavin, 86 Totara Crescent, Lower Hutt, New Zealand.
  17.     e-mail: peterm@maths.grace.cri.nz
  18.  
  19.  
  20. FEATURES:
  21. ---------
  22.  
  23. Plays either from ram or directly from disk (e.g, when not enough ram
  24. is available).
  25.  
  26. Uses AGA 256-colour mode when AGA is available.
  27.  
  28. Extra-Half-Brite mode (EHB) allows reasonably good colour
  29. approximation on ECS Amigas.
  30.  
  31. Falls back to EHB when AGA is not available.  Falls back to disk play
  32. when not enough ram is available.
  33.  
  34. Uses an Intuition-friendly double-buffered Screen.  You can flip it
  35. to the back, or drag it down in the usual way, while an animation is
  36. playing.
  37.  
  38. Uses the ASL file-requester.
  39.  
  40. Runs quite fast on a range of Amiga models.
  41.  
  42. Source code is included, so if something doesn't work you can fix it.
  43.  
  44.  
  45. OPERATION:
  46. ----------
  47.  
  48. I've tried to make it easy to use in many different ways.
  49.  
  50. Just double-click the Flick icon and select an anim to play from the
  51. requester.
  52.  
  53. Alternatively you can set up project icons for your anims (e.g, with
  54. IconEdit).
  55.  
  56. From the SHELL or CLI there are some more options available.  The
  57. syntax is:
  58.  
  59.     FLICK FILE/M,DISK/S,RAM/S,EHB/S,GREY/S,COLOUR/S,ONCE/S
  60.  
  61. If you don't specify a file, the file-requester pops up.
  62.  
  63. You can specify a list of files, separated by spaces.  However #?
  64. wildcards don't work.
  65.  
  66. The DISK and RAM options force Flick to play directly from disk or
  67. to load the anim into ram first.
  68.  
  69. The EHB, GREY and COLOUR options (also GRAY and COLOR are accepted)
  70. force the particular operating mode.
  71.  
  72. To quit an animation, press ESC, Q, q or CTRL/C.
  73.  
  74.  
  75. OTHER FREELY DISTRIBUTABLE FLI PLAYERS FOR THE AMIGA:
  76. -----------------------------------------------------
  77.  
  78. Other FLI viewers I know about are:
  79.  
  80.     Flit 1.0 by John Bickers.
  81.  
  82.     AmiFlick v1.05 by Garrick Meeker.
  83.  
  84.     Flip 1.41 ???
  85.  
  86. These should all be available on Aminet.
  87.  
  88.  
  89. WHY IS IT SO SLOW?
  90. ------------------
  91.  
  92. Well actually I think it's quite fast for what it does.
  93.  
  94. FLI-format is exactly the wrong format for the Amiga.  That is,
  95. everything is stored internally in "chunky" format, but the Amiga has
  96. its graphics video-memory arranged in "planar" format.  All known
  97. algorithms to convert between chunky and planar format are very, very
  98. slow.
  99.  
  100. I have used a combined blitter+cpu c2p algorithm.  That is, the
  101. blitter and cpu work together on different parts of the display at the
  102. same time.  The algorithm is optimised for a 68020 or 68030 with FAST
  103. memory and should still give reasonable results on a 68000 or 68040.
  104. If you manage to improve the algorithm significantly, or find a faster
  105. one, please let me know.
  106.  
  107. For EHB and GREY modes, the program has to make an extra translation
  108. for every pixel.  In EHB mode the program must performs calculation
  109. every time the colour map changes.
  110.  
  111. If you really want to see a FLI-format file played fast, convert it to
  112. an Amiga anim format first.  AmiFlick can write IFF files and supports
  113. quite a good HAM mode.  Some of the commercial anim utilities, like
  114. ImageFX, can convert directly from FLI to anim.
  115.  
  116.  
  117. BUGS:
  118. -----
  119.  
  120. Bugs?  What bugs?  Oh well, maybe some of the following can be
  121. construed as bugs:
  122.  
  123. Probably crashes on pre-ECS Agnus Amigas running OS2.04 & up (untested).
  124. Anims with lots of colour map changes don't play correctly in EHB or GREY.
  125. Doesn't recognise Tool Types, so options are not available from WB.
  126. Doesn't quite work with .FLC files yet.
  127. Can't select multiple files from file requester.
  128. Can't use #? wildcards on commandline.
  129. Stdio output window is ugly.
  130. Might fail with RTG due to writing directly into Screen's BitMap.
  131. Converts all 8 planes from chunky to planar even when only 4 or 6 are used.
  132. Uses heaps of chip ram.
  133. The frame-speed stored in the FLI file is ignored.
  134.  
  135.  
  136. THANKS:
  137. -------
  138.  
  139. Thanks to James McCoull for his 4-pass blitter c2p routine.
  140.  
  141.  
  142. DISCLAIMER:
  143. -----------
  144.  
  145. I wrote this program in the last 4 evenings 15-18th Dec 1993 (except
  146. for the c2p routine).  It seems to work for me.
  147.  
  148.  
  149. HISTORY:
  150. --------
  151.  
  152. 19 Dec 1993: First release.
  153.